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RESET PROCEDURE 

1. Press BREAK. If no response, proceed to step 2. 

2. Press BREAK and RESET button on left rear of cpu if you 
have an expansion interface, otherwise press RESET button. 

3. ENTER for "MEMORY SIZE?" (expansion interface case). 

4. Enter "SYSTEM" for ">" prompt. 

5. Enter one of three restart addresses: 

a. /17280 restarts and destroys contents of edit buffer. 

b. /17283 restarts with contents of edit buffer preserved. 

c. /17286 restarts with Z-BUG breakpoints and edit buffer 
preserved. 



EDTASM-PLUS 
SPECIAL CHARACTERS 



Character Description and Use 



Shift • 
Shift t 



Shift® 



Break 



"C" 



Backspace deletes the previous character on line 
input for Editor, Assembler, or Z-BUG. 

Deletes the entire input line. 

Escape character, displayed as "$". Used in Editor 
and Z-BUG as delimiter. Cannot be deleted by 
backspace {■*—) or line delete (SHIFT — ) while in 
Z-BUG. 

Holds the display during multiple line listing in 
Editor, Assembler, or Z-BUG. Hitting any key except 
BREAK will restart the display. 

Generally used to return to "command" level in 
Editor, Assembler, or Z-BUG. 

During "wait on error" wait in Assembler operation, 
C may be pressed to continue without error wait. 



EDITOR RANGES OF LINES 



Format Example 

Start:End 100:300 



SLN!n 



10015 



Offset 100 + 5 

300-12 



Description 

Range of lines specified in this format 
is from "start" line number to "end" 
line number inclusive. 

Range of lines specified in this format 
is from starting line number (SLN) and 
through the line count "n". Line count 
is number of lines, including the SLN, 
that is to be used in the range. 

A positive or negative offset may be 
used to specify the "line n lines away" 
from a given line. 



EDITOR COMMANDS 



Command 

Basic 
Copy 



Delete 

Edit 

Find 



Quash 



Quash 



Substi- 
tute 



Format 



Description 

Return to Level II BASIC. 



*Ctln,line1:line2,[inc] Copy lines defined by range 

to area starting with line 
number "tin" and with incre- 
ment "inc". 

*D[line1 [:line2]J Delete range of lines 

specified. 

*E[line1 [:line2]J Block edit of range specified. 

*F[line1 [:line2]][$string] 

Find string "string" and 
display all occurrences. 



Insert *l[line1 [ T inc]J 



Insert following lines starting 
at "line"!" and incrementing 
by "inc". 



Hard- 
copy 


*H[line1[:line2]] 


Output lines defined by range 
to system printer. 


Load 


l_[&filename] 


Load file "filename" from 
cassette tape. 


Move 


*Mtln,line1:line2,[inc] 


Move lines defined by range 
to area starting with line 
number "tin" and with incre- 
ment "inc". 


Number 


*N[line[,inc]] 


Renumber lines starting at 
line "line" and incrementing 
by "inc". 


Print 


*P 


Display the next 16 lines. 


Print 


*p[line1 [:line2]] 


Display the range of lines 



*QA 



*QZ 



Replace R[line[,inc]] 



specified. 

Quash Assembler and Z-BUG 
to obtain more memory. 

Quash Z-BUG to obtain more 
memory. 



Replace lines starting at 
"line" with following lines and 
increment "inc". 

S[line1 [:line2]][$string1 ] [$string2] 

Substitute "string2" for every 
occurrence of "stringl" over 
range. 



Command 


Format 


Description 


Type 


*T[line1 [:line2]] 


Print only text of lines in 
range defined. 


Write 


*W[tofilename] 


Write out contents of edit 
buffer to cassette as file 
"filename". 


EXtend 


*x[line1 [:line2]] 


Extend lines in insert mode 
over defined range. 


t 1 




Scroll up (t) or down (1). 



KEY: 1. 



2. 
3. 
4. 
5. 



Iine1:line2 format may be replaced by "for how 
many lines" format of sln!n where "sin" is start- 
ing tine number and "n" is the line count. Line 
number offsets may also be used at any time. 

Brackets indicate optional arguments. 

"to" indicates optional blanks. 

"line" defaults to current line if none entered. 

"inc" defaults to last entered increment if none 
entered. 



EDIT MODE SUBCOMMANDS 



Subcommand Format Description 



Again 
Backspace 

Change 

Delete 
End edit 
End edit 
EXtend line 
Hack 
Insert 



A 

n — 

nCstring 

nD 



ENTER 



H 



(string 



Cancel all changes and restart. 

Move cursor n positions left. 

Change n characters at current cur- 
sor position to "string" characters. 

Delete n characters at current cur- 
sor position. 

End edit and enter all changes 
without displaying remainder of line. 

End edit and enter all changes and 
display remainder of line. 

Move to the end of line and enter 
insert mode. 

Delete line from current cursor posi- 
tion to end and enter insert mode. 

Enter insert mode before current 
cursor position. Terminate with 
SHIFT, up arrow t. 



Subcommand Format Description 



Kill 



nKs 



List line 



Quit 



Search 



Space 



Q 



nSs 



Kill all characters from current cur- 
sor position to nth occurrence of 

"s". 

List line and position cursor to start 
of line in following line. 

Quit Edit mode and ignore all 
changes. 

Search for the nth occurrence of 



V\ 



nspace Move cursor n positions right. 



EDITOR ERROR MESSAGES 



Message 

BAD COMMAND 
BAD LINE NUMBER 



BAD PARAMETERS 



BUFFER EMPTY 



BUFFER FULL 



NEW LINE TOO LONG 



NO ROOM BETWEEN 
LINES 



STRING NOT FOUND 



Description and Corrective Action 

Editor does not recognize command. 
Is it valid? 

Editor cannot find line number. Check 
to see if line is actually present in the 
edit buffer. 

Editor cannot decode the operands for 
the command. Check format. 

User has specified operation on a line 
when buffer is empty. Reload or 
reenter text. 

No more room in the edit buffer. 
Quash Z-BUG or Z-BUG and Assembler 
to get more space, or break up pro- 
gram into separate modules. 

Substitute has been performed that 
resulted in a line greater than 128 
characters. Shorten the line. 

Insert, move, or copy action resulted 
in too many lines to fit between ex- 
isting lines. Renumber existing, lines 
with larger increment. 

Find or Substitute command specified 
a string that cannot be found. Check 
the search string for proper characters. 






ASSEMBLER PSEUDO-OPS 



Pseudo-op Format 

COND — COND 



DEFB 



DEFL 



DEFS 



END 



(label) DEFB 



Description 

expression Controls conditional 

assembly of following 
code until matching 
EN DC. 

expression Generates a single byte 

as defined by expression. 



label DEFL expression 



DEFM (label) DEFM 'string' 



Sets "label" equal to 
value of expression, 
"label" may be subse- 
quently redefined by 
another DEFL 

Generates one byte 
ASCII characters for 
every character in 

"string". 



(label) DEFS 



expression Reserves amount of 

storage in bytes equal to 
value of expression. 



DEFW (label) DEFW expression 



ENDC — 



ENDC — 



ENDM — 



ENDM - 



Generates two bytes as 
defined by expression. 
Bytes are in standard 
Z-80 address format. 

Terminates conditional 
assembly section started 
by matching COND. 

Terminates macro defini- 
tion started by MACRO. 



— END 



(expression) Denotes end of source 

code. Optional expres- 
sion defines starting ad- 
dress for program. 



EQU 



label EQU expression 



Equates "label" to value 
of expression. 



MACRO label 



MACRO (#P1,#P2, . Denotes start of macro 
. . . #PN) definition terminated by 
ENDM. Optional 
parameter string defines 
dummy arguments. 



Pseudo-op Format Description 

ORG — ORG expression Defines origin of 

following code as 
defined by value of ex- 
pression. 

Key: "— " means not allowed. "( )" means optional. No 
parentheses means necessary label or expression. 



ASSEMBLER/Z-BUG EXPRESSION 
EVALUATION 



Operation 


Symbol Precedence 


Notes 


Addition 


+ 

• 


2 




Subtraction 




2 




Multiplication 


* 


5 




Division 


/(Assembler) 


5 


"/" opens location in 




.DIV. (Z-BUG) 




Z-BUG 


Logical AND 


.AND. or & 


4 


Takes two arguments 


Logical OR 


.OR. or ! 


3 


Takes two arguments 


Logical XOR 


.XOR. 


3 


Tpkes two arguments 


One's 
complement 


.NOT. 


6 


Takes one argument 


Shift 


< 


5 


Positive count is left, 
negative count right 


Modulo 


.MOD. 


5 


Takes two arguments 
as in a divide 


Equals 


.EQU. or = 


1 


Takes two arguments 


Not equals 


.NEQ. 


1 


Takes two arguments 


Parentheses 


O 


7 


Must never open an 
expression 


Octal suffix 


or Q 






Hexadecimal 
suffix 


H 


■ 




Decimal suffix 


T or unsuffixed 






ASCII character 


'char' 






Assembler loca- 


$ or . 




$ may be confused 


tion counter 






with Z-BUG escape 



Key: 1 indicates lowest precedence; 



character printout. 
7 indicates highest. 



ASSEMBLER COMMANDS OTHER 
THAN PRINTING 



To Assemble: 

*A&NAME&/SW/SW . . . /SW 



To Define User Origin 

*0 



To Quash Z-BUG 

*QZ 



Assembles from edit buffer. If 
object is output to cassette, 
Assembler uses optional name 
"NAME" (leading and trailing 
blanks are optional). /SW 
represents optional assembler 
switches (see "Assembler Swit- 
ches"). 



Allows user to examine or 
define user origin for /MO 
assemblies. 



Quashes Z-BUG portion of 
EDTASM-PLUS, allowing addi- 
tional area for edit buffer, sym- 
bol table, and in-memory ob- 
ject. 



ASSEMBLER SWITCHES 



Switch Description 



/AO 

/IM 

/LP 

/MO 

/NL 

/NO 

/NS 

/WE 



Assemble with absolute origin. 
Assemble object directly into memory. 
Output listing and symbol table to line printer. 
Assemble with user-specifed origin. 
Suppress listing printout or display. 
Suppress object output. 
Suppress symbol table printout or display. 
Wait on errors until key depressed. 



ASSEMBLER PRINTING COMMANDS 



Command 


Format 


LIST ON 


* LIST ON 


LIST OFF 


♦ LIST OFF 


MUST ON 


*M LIST ON 


MUST OFF 


* MUST OFF 



Description 

Assembler command. Enables 
display or printing of assembly 
listing until *LIST OFF. 

Assembler command. Disables 
display or printing of assembly 
listing until *LIST ON. 

Assembler command. Enables 
display or printing of macro ex- 
pansions until *MLIST OFF. 

Assembler command. Disables 
display or printing of macro ex- 
pansions until *MLIST ON. 



ASSEMBLER SYMBOL TABLE 
CODES 



Code 

D 

F 

M 
R 

U 



Description 

Symbol has been defined by a DEFL pseudo-op. 

Symbol is a macro name used erroneously before 
definition of the macro. 

Symbol is a macro name. 

Symbol has been erroneously defined more than one 
time. 

Symbol has been erroneously referenced but never 
defined. 



ASSEMBLER ERROR MESSAGES 



Message 



BAD ADDRESS 



BAD ADDRESSING MODE 



Description and Corrective 
Action 

Invalid address defined for 
USRORG command or address 
above LAST or below USRORG 
on assembly. Use an address 
between FIRST and LAST. 

Operands use incorrect address- 
ing mode. Use valid addressing 
for the instruction. 



Message 



BAD EXPRESSION 



BAD MEMORY 



BAD LABEL 



BAD OPCODE 



BRANCH OUT OF RANGE 



DIVISION BY 



ENDC WITHOUT COND 



ENDM WITHOUT MACRO 



FIELD OVERFLOW 



MACRO FWD REF 



MISSING INFORMATION 



MULTIPLY DEFINED SYMBOL 



MULTIPLE DEFINITION 



Description and Corrective 
Action 

Syntax of expression in source 
line incorrect. Redefine. 

Assemble into memory verify 
does not compare. Check RAM. 

Invalid label has been used. Use 
1 to 6 character label, starting 
with an alphabetic character. Do 
not use "reserved" (system) 
words. Check label. 

Invalid opcode or pseudo-op 
mnemonic has been used. Check 
spelling. 

Relative address displacement 
on JR or other instruction is 
greater than + 127 or less than 
-128. Use JP or another instruc- 
tion. 

Expression used as a divisor. 
Use non-zero value. 

ENDC encountered without a 
prior COND. Check for existence 
of COND. 

ENDM encountered without a 
prior MACRO. Check for ex- 
istence of MACRO. 

Instruction field cannot hold 
value used as an operand. 
Change value to fit. 

Macro invoked before definition. 
Define macro before reference. 

Operands missing or incomplete 
in source line. Check format of 
instruction or pseudo-op. 

Reference to multiply defined 
symbol. (See next error 
message). 

Same label was used again. 
Change to one unique label for 
each line. 



Message 



NESTED MACROS 



NO END STATEMENT 



STACK OVERFLOW 



SYMBOL TABLE OVERFLOW 



SYNTAX ERROR 
UNDEFINED SYMBOL 



Description and Corrective 
Action 

Nested macros are not allowed. 
Redefine macros. 

No END pseudo-op at end of 
source code. Add END. 

Expression too involved for 
stack. Simplify. 

Too many labels used in source 
program. Shorten or delete labels 
(use $). 

Macro syntax incorrect. Check. 

Symbol encountered that is not 
defined as label, EQU, DEFL, or 
MACRO. Define. 



Z-BUG COMMANDS 



Command 
A 

B 
C 



Format 

$A 
$B 
(continue count)$C 



Description 

Set ASCII type-out mode. 

Set byte examination mode. 

Continue from current 
breakpoint for a number of 
times equal to continue 
count. 





$C 


Resume program execution. 


D 


$D 


Display current breakpoints- 


E 


$E 


Return to system command 
mode. 


G 


(address)$G 


Execute program starting at 
address "address". 



$G 



(radix)$l 



Execute program pointed to 
by user's program counter. 

Set input radix to "radix". 
Radix may be 2 through 16 



L 


tonameSL 


Load SYSTEM-format tape. 


M 


$M 


Set mnemonic examination 
mode. 



Command 

N 

O 



R 
S 



w 



i 



Format 

$N 



(radix)$0 



Description 

Set numeric debugging 
mode. 

Set output radix to "radix" 
Radix may be 8, 10, or 16. 



(first)to(last)to(execution)K>NAME$P 

Output SYSTEM -format tape 
from address "first" through 
address "last" with execu- 
tion address "execution" 
and file name "NAME". 



$R 
$S 

(first) l6(last)$T 



$W 

(address)$X 

(value)$Y 

$Y 
*Z 

I 
I 

/ 
(expression) = 



Display all registers. 

Set symbolic debugging 
mode. 

Display block of locations 
from address "first" through 
address "last". 

Set word examination 
mode. 

Set breakpoint at address 
"address". 

Yank breakpoint number 
"value". 

Yank all breakpoints. 

(Editor/Assembler com- 
mand.) Entry into Z-BUG. 

Examine next location. 

Examine previous byte. 

Reopen current location. 

Display value of expression. 

Force one-time typeout of 
current location in numeric 
mode. 

Force one-time type-out of 
current location in byte ex- 
amination and numeric 
modes- 



Command Format 



(address)® 



Description 

Open new location based 
on current instruction 
(mnemonic mode) or current 
location address. 

Force one-time typeout of 
current location in flags 
mode format. 

Single step from address 
"address". 

Single step from current in- 
struction. 



Key: $ is SHIFT t (ESCAPE) 

Z-BUG ERROR MESSAGES 



Message 

BAD EXPRESSION 

BAD MEMORY 

DIVISION BY 

STACK OVERFLOW 

■ 

UNDEFINED SYMBOL 
ZERR 



Description 

Syntax of expression incorrect. 
Redefine. 

Memory verify does not compare. 
Check RAM. 

Expression used as a divisor. Use 
non-zero value. 

Expression too involved for stack. 
Simplify. 

Symbol cannot be found in symbol 
table. Reenter or verify that it exists. 

One of the following: 

-Expression followed by ";"■ 

-Illegal ESCAPE command 
character. 

-Internal breakpoint problem. 

•Illegal input or output radix. 

-Attempt to set more than 8 
breakpoints. 

-Attempt to set a breakpointed 
location. 

-Attempt to breakpoint register. 

-Attempt to breakpoint an RST in- 
struction. 

-Continue count of 0. 

-Continue without breakpoint con- 
dition. 



